home *** CD-ROM | disk | FTP | other *** search
/ Acorn User: China / Acorn User China CD-ROM (UK) (Disc B) / Acorn User China CD-ROM (UK) (Disc B).bin / WEBSITES / FORTRAN_FRIENDS / STELLA.ZIP / ReadMe < prev   
Encoding:
Text File  |  1999-03-04  |  11.9 KB  |  275 lines

  1.                      !Stellate (Demo Version)
  2.   ‘Fortran Friends’, P.O.Box 64, Didcot, Oxon, OX11  0TH
  3.               telephone:  +44  (0)  1235  834357
  4.  
  5. Introduction
  6.      !Stellate is an interactive program which creates uniform polyhedra and
  7. their stellations. The full version allows you to save:
  8.  • Draw files of the stellation diagrams,
  9.  • Draw files of the 3D solids,
  10.  • data files for Stellate,
  11.  • PolyData for PolyDraw and PolyNet
  12. and to print views of polyhedra directly.
  13. You can not print nor save any files with this demo version and can only use
  14. the supplied data files.
  15.  
  16. Machine and operating system requirements: Any Acorn computers using RISC-OS
  17. operating systems: 3.XX, including networks and StrongARM with 288K spare
  18. Application memory space.
  19.  
  20. Copyright and copying: 
  21. This program remains the copyright of ‘Fortran Friends’; this demo version
  22. is given to you on the understanding that if you give a copy to anyone else
  23. you will copy all the files, unchanged, including this one.
  24.  
  25. To get the Full Version:
  26.  
  27.  Send a cheque for £20 payable to ‘Fortran Friends’ at the address above. 
  28.  
  29.   With the full version you can:
  30.  
  31.   1. Save diagrams and 3D views as ‘Draw’ files or to !Draw for printing and
  32.       combining with others.
  33.   2. Save new polyhedra for reading back into !Stellate
  34.   3. save PolyData for !PolyDraw and !PolyNet.
  35.   4. Use more data files; the standard distribution data file contains
  36.       instructions for drawing 112 polyhedra.
  37.   5. Use your own new data files.
  38.   6. Read more documentation (see below)
  39.   7. Send us suggestions for improvements and report problems which we will
  40.       try to correct.
  41.  
  42.                       Contents of the !Stellate Demo Disc
  43.                        
  44. Top level directory
  45.  
  46.   !Stellate demonstration application
  47.   Products - software available from Fortran Friends
  48.   AllPoly  - A squashed sprite showing all the polyhedra available on the
  49.              standard distribution data file.
  50.   ReadMe   - This file
  51.  
  52.   Within the !Stellate application, in addition to the usual files, there is
  53. the first standard tutorial (Tutorial1) which you may use with the demo
  54. restricted data file. There is also a sub-directory, ‘Resources’, with files
  55. used by the program. You must not change any of the files in this directory.
  56.  
  57. --------------------------------------------------------------------
  58.  
  59. Documentation files supplied with the full version of !Stellate
  60.  
  61.     Text files:
  62.  
  63.   BookKits   - WWW URLS, suggested reading, and suppliers of model kits
  64.   CopyRight  - a statement of ‘Fortran Friends’ copyright
  65.   FaultRep   - a form for you to return if you find any problems
  66.   Versions   - record of the differences between versions of !Stellate
  67.   WishList   - current planned enhancements for !Stellate
  68.  
  69.  
  70.     Directory ‘Reference’:
  71.  
  72.   Component  - Draw file showing the characteristics of the 9 possible
  73.                components used to make polyhedra in !Stellate
  74.   CrossRef   - listings of the polyhedra stored in ‘Resources.StellaList’
  75.                in various orders 
  76.   Faces      - Draw file showing the characteristics of the 9 possible
  77.                face types used to make polyhedra in !Stellate
  78.   FormChoice - defines the format of ‘Resources.Choices’ file
  79.   FormCols   - defines the format of ‘Resources.Colours’ file
  80.   FormComps  - defines the format of ‘Resources.Components’ file and
  81.                explains how to enter formulae instead of numbers
  82.   FormList   - defines the format of ‘Resources.StellaList’ file
  83.   Glossary   - defines terms associated with polyhedra
  84.   Intro      - explains what uniform polyhedra are and gives an introduction
  85.                on how to make them using !Stellate
  86.   ReadStel   - skeleton BASIC program for reading ‘Resources.StellaList’
  87.   WennError  - some problems in the stellation diagrams in the book:
  88.                ‘Polyhedron Models’ by M.J. Wenninger
  89.   WennIndex  - Type and alphabetical list of the polyhedra in 
  90.                ‘Polyhedron Models’ by M.J. Wenninger
  91.  
  92.     Directory ‘TryThese’:
  93.  
  94.   Activities - suggestions for things to try out with !Stellate. It is
  95.                organised as a series of questions.
  96.   Answer-n   - compressed Draw files and text files giving possible answers
  97.                to the questions posed in ‘Activities’
  98.   NewLine9   - StellaList format file answer to question 9.
  99.  
  100.  
  101.     Directory ‘Tutorials’ contains three tutorials to help show you what
  102. is possible with !Stellate. Each assumes that you have worked through the
  103. previous ones.
  104.  
  105.   Tutorial1 - Instructions for beginners - shows how to make the 3D view
  106.               plot from the stored command data (this is included also with
  107.               the demo version of !Stellate)
  108.  
  109.   Tutorial2 - Instructions for making your own selections from the
  110.               stellation diagram to make your own version of a polyhedron
  111.               from the stored instructions; the second section shows how to
  112.               select star faces and selecting faces from more than one
  113.               component
  114.  
  115.   Tutorial3 - Instructions for making a new polyhedron by selecting your
  116.               face types to make stellation diagram(s) and a new polyhedron 
  117.  
  118.   pictures  - sub-directory of squashed Draw files of figures used in the
  119.               tutorials
  120.  
  121.  
  122. --------------------------------------------------------------------
  123.        
  124. The rest of this file is the ‘ReadMe’ from the full version.
  125.  
  126. **************************************************************************
  127.                    ReadMe for  !Stellate 
  128.                  last updated 15 Feb 1998
  129.  
  130.  !Stellate is an interactive program which creates uniform polyhedra and
  131. their stellations using stellation diagrams. There are 112 pre-stored 
  132. polyhedra which are printed on the single A4 page enclosed in your manual. 
  133. !Stellate is written in the Fortran programming language by:
  134.  
  135.  ‘Fortran Friends’, P.O.Box 64, Didcot, Oxon OX11 0TH
  136.  
  137.    tel: (01235) 834357
  138.  
  139. Machine and operating system requirements: 
  140.  
  141. Any Acorn computers using RISC-OS operating systems 3.XX and at least 288K
  142. available application workspace, including networks and StrongARM.
  143.  
  144. Copyright and copying:
  145.  
  146. Further details can be found in the file ‘Docs.CopyRight’
  147. This program remains the copyright of ‘Fortran Friends’: it is licensed for
  148. use at one site only; you may copy it to a backup floppy disc or to your own
  149. hard disk but giving copies to others is illegal. Your registration number
  150. is unique; any illegal copies found will be reported to the ‘Federation
  151. Against Software Theft’ and you will be liable for prosecution. 
  152.  
  153. Getting Started:
  154.  
  155. These instructions assume some knowledge of how to use an Acorn computer. 
  156. If you are a new user, more detailed instructions on how to copy files, use
  157. the windows and the mouse can be found in the ‘User Guide’ manual for your
  158. computer system. !Stellate is a RISC-OS compliant program which runs in the
  159. Acorn Desktop and tries to conform to the operating conventions in the Acorn
  160. Style guide; it supports Acorn interactive help.
  161.  
  162. Fortran Friends welcome comments and requests for new features for future
  163. versions of this program. 
  164.  
  165. --------------------------------------------------------------------
  166.                       Contents of the !Stellate Disc
  167.  
  168. This section is for reference only, you may never need to use it if you just
  169. want to use the supplied data file to create and save stellations. All Draw
  170. files on the distribution disc have been compressed using the standard
  171. ‘Squash’ program.
  172.  
  173. Top level directory
  174.  
  175.   !Stellate - application
  176.   Docs      - directory of documentation; ‘Docs.Readme’ explains what is in
  177.               each file
  178.   Products  - software available from Fortran Friends
  179.   ReadMe    - (This file)
  180.  
  181. Skip to the section headed ‘Installation’ if this is the first time you have 
  182. looked at this file, and you are not interested in technicalities.
  183.  
  184.    Within the !Stellate application, in addition to the usual files, 
  185.    there is the directory ‘Resources’.
  186.  
  187.    This has the standard Acorn files, ‘Messages’ and ‘Templates’;
  188.    there are several other files, which the program may change for you,
  189.    but which most users need not bother with.
  190.  
  191.     ‘Choices’   defines the initial settings of various options.
  192.     ‘Colours’   defines all the colours used initially. The program can
  193.                 change this file if the user changes the colours and then
  194.                 asks to save the ‘Colours’ file before quitting the program.
  195.     ‘Components’ definitions of components’ names, symmetry and interplanar
  196.                 angles.
  197.     ‘Register’  this file contains your name and registration information.
  198.                 It must not be changed by the user.
  199.     ‘Sprites’   sprites used in the tools pane of the 3D display window.
  200.     ‘StellaList’ list of instructions for drawing stored polyhedra
  201.  
  202.  --------------------------------------------------------------------
  203.  
  204. Installation:
  205.  
  206. 1. Make a working copy on floppy disc. Store the original safely, in case
  207. your working copy becomes damaged. Your license allows you to make a
  208. single copy for your own use. If the disc supplied has been damaged and
  209. will not copy, return it to us for a free replacement within 3 months of
  210. purchase.
  211.  
  212. Use the ‘working’ copy for the rest of the instructions. You can run from
  213. the floppy if you want to.
  214.  
  215. 2. Installation on hard disc: 
  216. Make yourself a directory for storing your programs, with a name such as
  217. ‘Polyhedra’ and copy the contents of the floppy disc to it.
  218.  
  219. 3. Read the Documentation. 
  220. Before trying to run the application, look at the file !Help file for
  221. operating instructions, and in the directory ‘Docs.Reference’ for a glossary
  222. of terms and an ‘Intro’ which explains how !Stellate uses stellation
  223. diagrams to draw polyhedra. The sub-directory ‘Tutorials’ has more detailed
  224. explanations with Draw file figures to help you understand better how to get
  225. the most from !Stellate. The directory ‘TryThese’ has some suggested
  226. activities and answers. You may want to print some of these out for future
  227. reference.
  228.  
  229. 4. Operating instructions:
  230. Running instructions are in the file !Help of the application. 
  231. Acorn interactive help is supported.
  232.  
  233. 5. Starting the program:
  234.  
  235. Double-click on the application !Stellate to start the program; this loads
  236. an icon on to the icon bar. Click MENU when the pointer is over this icon to
  237. see the options.  Choose ‘info’ to see the program name, version number and
  238. your registration number, which should be quoted in any correspondence with
  239. ‘Fortran Friends’. Click SELECT to choose a polyhedron.
  240.  
  241. 6. Stopping the program:
  242.  
  243. Click MENU over the icon on the icon bar and choose the last option, ‘quit’.
  244. If windows are hiding the icon bar, press key F12 while holding down the
  245. SHIFT key, to bring the icon bar to the front of the windows.
  246.  
  247. 7. Colour Changing:
  248. You can change the colour used for particular faces of a polyhedron in some
  249. of the display forms, and other colours of lines, or window backgrounds etc.
  250. from the icon bar menu. If you try to do this and get an error message saying
  251. ‘Colour Picker module is not loaded’, then if you have a copy of the Acorn
  252. Colour Picker Module load it using commands as described in the !Run file.
  253. If you have not got this module you can get it off the Acorn User Cover Disc
  254. for September 97 (in directory ‘System.!System.Modules.Toolbox’) or send a
  255. blank disc plus return envelope and postage to ‘Fortran Friends’ at the
  256. address above.
  257.  
  258. 8. Possible Faults:
  259.  
  260. Error conditions we have thought about have ‘traffic sign’ windows which
  261. should allow you to choose whether to stop the program or try to carry on.
  262.  
  263. If your working disc is damaged, you may find when you try to start the
  264. program you merely get an ‘error window’ saying your user registration file
  265. has been corrupted. Delete all the files from your working disc, and make a
  266. new copy from your original disc. 
  267.  
  268. If you find the program stops in an uncontrolled way, please try to write
  269. down details of what you were doing just before the error, and send them to
  270. us, preferably using the fault report form in file ‘Docs.FaultRep’. 
  271.  
  272. If you have changed any of the !Stellate files, please supply copies of the
  273. files on floppy disc which you were using when the error occurred.
  274.  
  275.